List box controls display a menu containing one or more selection options in a list box format. The user may select an option from the available list items as the active control option.
The user-selected option is highlighted in the list box view. List box options can be navigated by highlighting or tabbing into the control and using the arrow keys to move up and down the list of items available in the control. VectorScript API functions for retrieving and managing pulldown menu control options also work with list box controls.
As of VectorWorks 10, list boxes can have multiple columns, each with its own column width. By default, list boxes are created with one column. To add a column, use the VectorScript function AddListBoxTabStop, which takes a tab stop as a parameter. Each tab stop is given as a character position. Hence, each succeeding tab stop must be at a greater character position than the previous one.
Once all tab stops have been set up, data can then be added to the list box (all tab stops must be set before data can be added). Data is added in the usual way, using calls to InsertChoice. To align text at a tab stop, tab characters are inserted in the string passed to InsertChoice. The string for an entire line must be passed to InsertChoice all at once; it is not possible to pass just a part of a line.